************************* Use C-Pg Up to return *******************************
********************* Use Pg Up and Pg Dn to scroll ***************************
*************************** Use C-s to search *********************************
Copyright (C) 1993 Leon van Dommelen      There is no warranty on this software
Library letter: A (ABBREV.ED)

				  Abbrev

This file covers the abbreviations of Freemacs Mint II.


Topics:				Description
-------------------------------------------------------------------------------

About				Copyright, no warranty, history

Intro				What are abbreviations

Summary				Listing of abbrev functions
- Defining Abbrevs		Various ways
- Expanding Abbrevs		Automatic or on demand
- Listing Abbrevs		Show all abbrevs
- Managing Abbrevs		Delete, save, restore them

Memory				How to reduce memory used by abbrevs


				= About =
-------------------------------------------------------------------------------


Abbrev mode is free software; you can redistribute it and/or modify it under
the terms of the GNU General Public License as published by the Free Software
Foundation; either version 1, or (at your option) any later version.

Abbrev mode is distributed in the hope that it will be useful, but WITHOUT ANY
WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A
PARTICULAR PURPOSE.  See the GNU General Public License for more details.

You should have received a copy of the GNU General Public License along with
Abbrev mode in file LICENSE.HLP; if not, write to:

			The Free Software Foundation, Inc.
			Kendall Square
			Cambridge, MA 02130
			USA

Written by:

			Leon van Dommelen

See subject:		Contact			Contact Leon van Dommelen


History:
--------

Replaces an Abbrev mode included with Freemacs version 1.6, subject to
the Free Software foundation license in file LICENSE.HLP.

See subject:	License, topic GNU License	for the license


				= Intro =
-------------------------------------------------------------------------------

Freemacs allows you to define abbreviations using a key sequence such as C-x -
and later expand the same abbreviation using C-x '.

Use them to abbreviate keywords, to abbreviate common words, or even to
correct typos (teh as an abbreviation for the).

For example, if your name is John J. Doe, you can define `i' as an abbreviation
of `John J. Doe' if you type in i and press C-x -.

Abbreviations can be defined to be specific to the mode, so that an
abbreviation can have a different meaning in a Fortran buffer than in a TeX
one. When the same abbreviation is defined more than once, one specific to the
current buffer mode has priority over one defined globally.  If there are also
system defined abbreviations for the mode, they have the least priority.

See topic:	Memory	for a warning against defining too many abbrevs


				= Summary =
-------------------------------------------------------------------------------

This topic summarizes the keys and commands related to abbreviations.

Defining Abbrevs:
-----------------

C-x -			Define the abbrev left of the cursor
See command:		inverse-add-abbrev

C-x +			Define an abbrev for the word[s] left of the cursor
See command:		add-abbrev

			Define an abbrev for the selected region
See command:		abbrev-region

C-x C-h			Define the mode-specific abbrev left of the cursor
See command:		inverse-add-mode-abbrev

C-x C-a			Define a mode abbrev for the word[s] left of the cursor
See command:		add-mode-abbrev

			Define a mode abbrev for the selected region
See command:		mode-abbrev-region


Expanding Abbrevs:
------------------

C-x '			Expand the abbrev left of the cursor
See command:		expand-abbrev

			Expand abbrevs left of the cursor when Space is pressed
See command:		Abbrev-mode

F8			Complete any word by searching
See command:		dabbrev


Listing Abbrevs:
----------------

			List all abbrevs
See command:		list-abbrevs

Managing Abbrevs:
-----------------

			Erase an abbrev
See command:		kill-abbrev

			Erase a mode-specific abbrev
See command:		kill-mode-abbrev

			Erase all abbrevs
See command:		kill-all-abbrevs

			Saving the modified abbrevs to disk
See command:		write-abbrev-file

			Restoring the abbrevs as defined on disk
See command:		read-abbrev-file

			M-x ef abbrev. allows the abbrevs to be edited
See command:		ef

				= Memory =
-------------------------------------------------------------------------------

Do not get carried away, defining more abbreviations than you really need.
Abbreviations take precious memory which Emacs can use for other tasks.
See command:	kill-abbrev	on how to get rid of unused abbrevs.

If you have a lot of Fortran, TeX, or C abbreviations that you want to define,
define them as system abbreviations.  System abbreviations are only loaded
into memory if the mode is loaded.  Moreover, they take less memory. (Also they
can perform tasks other than merely expand text.)

To edit the Fortran system abbreviations, select any Fortran buffer and issue
the command `M-x ef N='.  This puts all system abbreviations in a buffer.  Add
more abbrevs using the same format.  Press C-c C-c when done.

For LaTeX abbreviations, use `M-x ef T=', for plain TeX, `M-x ef Tp=', for
C ones, `M-x ef C='.

************************* Use C-Pg Up to return  ******************************
************************* Use Pg Up to scroll up ******************************
*******************************************************************************
